3Dlabs Wildcat Realizm Driver for Linux Driver Version: 2.0.1 Release number: 05 ------------------------------------------------------------------------------ Legal Notices ------------------------------------------------------------------------------ Copyright(c) 2005 3Dlabs, Inc. All rights reserved. Including software, file formats, and audio-visual displays; may be used pursuant to applicable software license agreement; contains confidential and proprietary information of 3Dlabs and/or third parties which is protected by copyright and trade secret law and may not be provided or otherwise made available without proper authorization. Restricted Rights Legend. Use duplication, or disclosure by the Government is subject to restrictions as set forth in subparagraph (c) (1) (ii) of the Rights in Technical Data and Computer Software clause at DFARS 252.227-7013 or subparagraphs (c) (1) and (2) of Commercial Computer Software -- Restricted Rights at 48 CFR 52.227-19, as applicable. Unpublished -- rights reserved under the copyright laws of the United States. ------------------------------------------------------------------------------ System Requirements ------------------------------------------------------------------------------ Hardware x86-64 system (Intel EM64T and AMD Opteron) Software RedHat Enterprise Linux Version 3 (64 bit) Linux 2.4.X version kernels only. XFree86 Version 4.3.0 XFree86 Development package. GCC compiler package. Kernel development package. Kernel source package for the current installed kernel. ------------------------------------------------------------------------------ Configuration Requirements ------------------------------------------------------------------------------ XFree86 Configuration Requirements The Wildcat Realizm card only supports 32 bit color. Changing the display from the X desktop to a setting less than "millions of colors" will not work correctly. The display color depth should be set to 24 in the XF86Config file. (See the "XFree86 Configuration" section below.) ------------------------------------------------------------------------------ Installation Help ------------------------------------------------------------------------------ Installing the Wildcat Realizm Driver Root privileges are needed to install, update or remove the driver. 1. Query all installed versions of the Wildcat Realizm driver. rpm -qa | grep wildcat 2. Remove ALL previously installed versions of the Wildcat Realizm driver. Execute this command for each driver version returned from the query. rpm -e 3. Install the new Wildcat Realizm driver. /bin/sh Where is the file name of the driver package you are installing. 4. Modify the XF86Config file. (See "XFree86 Configuration" section below.) Starting the Wildcat Realizm Driver 1. Start the Wildcat Realizm driver by starting X. This command does not typically require root privileges. startx Verifying the Wildcat Realizm Driver 1. To verify that the driver has started, execute the following command. lsmod | grep wildcat 2. If the driver is not found (or returns a value of 0), manually install the driver from the text mode console. This sequence requires root privileges. cd /lib/modules/$(uname -r)/kernel/drivers/char/drm insmod wildcat.o 3. Start the Wildcat Realizm driver by starting X. startx If the driver did not start after performing the manual steps, please contact 3Dlabs customer support. (See "Support Information" section below.) ------------------------------------------------------------------------------ XFree86 Configuration ------------------------------------------------------------------------------ Modify the sections in your XF86config file using the sample configuration file "XF86Config.sample" that is placed in the /etc/X11 directory when the Wildcat Realizm driver is installed. **** Do NOT copy XF86Config.sample over the original XF86Config file. **** The sample file may not work if the system's input devices are different than those defined in the sample file. Backup the original /etc/X11/XF86Config file before making any modifications. Below are summary descriptions of the XF86Config file sections relevant to graphics configuration. For more detailed information, see the XF86Config man page. Module section: The "Module" section contains a list of modules that will be loaded when XFree86 starts. This example defines the modules needed by the Wildcat Realizm driver. Section "Module" Load "GLcore" Load "dbe" Load "extmod" Load "fbdevhw" Load "glx" Load "record" Load "freetype" Load "type1" Load "dri" EndSection Monitor section: The "Monitor" section contains information about the display monitor. This example defines a generic monitor configuration suitable for most monitors. Section "Monitor" Identifier "Monitor0" VendorName "Generic Vendor" ModelName "Generic Model" HorizSync 31 - 66 VertRefresh 60 - 75 EndSection Device section: The "Device" section contains information about the graphics device. This defines the basic configuration for the Wildcat Realizm graphics device. Section "Device" Identifier "Wildcat Realizm" Driver "wildcat" VendorName "3Dlabs" BoardName "Wildcat Realizm" EndSection Screen section: The "Screen" section listed below shows the default settings for a Wildcat Realizm graphics card. This contains information about the display resolution and color depth. The identifier entry should match the Screen entry in the ServerLayout section. The Monitor entry should match the Identifier entry in the Monitor section. Ensure that monitor supports the display modes included in the Screen section. Section "Screen" Identifier "Screen0" Device "Wildcat Realizm" Monitor "Monitor0" DefaultDepth 24 SubSection "Display" Depth 24 Modes "1280x1024" "1024x768" "800x600" "640x480" EndSubSection EndSection DRI section: The "DRI" section is required for OpenGL support. The Mode value should be 0666 as shown. Section "DRI" Mode 0666 EndSection SeverLayout section: The "ServerLayout" section binds the Screen identifier to defined input devices. The Screen entry identifies the default screen that will be set up when running X and directs the X server to look for a section "Screen0" (in this example) for graphics screen setup. A corresponding "Screen0" section should be configured for Wildcat Realizm. Section "ServerLayout" Identifier "Default Layout" Screen 0 "Screen0" 0 0 InputDevice "Mouse0" "CorePointer" InputDevice "Keyboard0" "CoreKeyboard" InputDevice "DevInputMice" "AlwaysCore" EndSection ------------------------------------------------------------------------------ Support Information ------------------------------------------------------------------------------ For driver support and contact information, please visit our web site at www.3dlabs.com